5.1.2 创建提款数字币至任意钱包(商户自定义汇率)
#简要描述: 将数字币提现到钱包的提现业务接口,让用户能够将 usdt 转移到指定的钱包地址 (商户可自定义汇率)
创建支付订单
- 请求方式: POST
- 请求接口: https://网关域名/wallet-trade-merchant/v1/pay/blockchain/custom/rate/create
- 请求媒体类型( JSON 数据格式 )Content-Type: application/json
请求参数
参数名称 | 类型 | 必填 | 参数含义 | 参数说明 |
---|---|---|---|---|
key | string | 是 | 商户 key | 平台分配商户 key |
localOrderId | string | 是 | 商户平台订单号 | 商户生成唯一订单号 |
localUserId | string | 否 | 平台分配商户 | 商户号 |
notifyUrl | string | 否 | 回调地址 | 下发成功后,由 API 回调商户的地址(回调详情说明在最下方) |
successRedirectUrl | string | 否 | 地址 | 成功后自动跳转地址 |
currency | string | 是 | 币种 | 币种(钱包支持币种) |
network | string | 是 | 主网 | 主网(目前仅支持 TRON、BSC) |
address | string | 是 | 提款地址 | 提款地址 |
quoteCurrency | string | 是 | 订单报价币种 | 订单报价币种(需商户登录后台设置报价币种汇率) |
quoteAmount | string | 是 | 报价金额 | 报价金额 |
sign | string | 是 | 签名 | 详情见签名算法 |
请求 json 样例
{
"key": "9yUreYgTRtit39Dy",
"localOrderId": "111122212",
"currency": "USDT",
"network": "TRON",
"address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
"quoteCurrency": "CNY",
"quoteAmount": "10",
"sign": "8236defe6976dcc6798eeacbb43b955c"
}
支付返回 json 格式
返回 data 示例
{
"code": 0,
"success": true,
"message": null,
"data": {
"orderId": 273582559791593,
"localUserId": null,
"localOrderId": "111122212",
"orderType": "WITHDRAW",
"orderBizType": "WITHDRAW_ANY_DIGITAL_WALLET",
"targetType": "EXTERNAL",
"network": "TRON",
"address": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS"
}
}
data 参数说明
参数名称 | 类型 | 参数含义 | 备注 |
---|---|---|---|
code | number | 下单状态值 | 下单成功:0 |
success | boolean | 下单成功标识 | 下单成功:true 下单失败 false |
data | object | 包含以下参数 | |
orderId | string | 订单 ID | |
localUserId | string | 商户本地用户 ID | |
localOrderId | string | 商户本地订单号 | |
orderType | enum | 订单类型 | PAYMENT:支付订单 WITHDRAW:提款订单 |
orderBizType | enum | 订单业务类型 | orderBizType 类型说明如下 |
targetType | enum | 目标类型 | targetType 类型说明如下 |
network | string | 主网类型 | TRON |
address | string | 地址 |
orderBizType 类型说明:
1、PAYMENT_WALLET_SCAN Vpay钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至Vpay钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付
targetType 类型说明:
1、INTERNAL 内部地址
2、EXTERNAL 外部地址
3、USER 用户抽象地址
回调详情说明
回调的方式是:POST application/json
回调参数 json 化示例
{
"amount": 1,
"bizType": "WITHDRAW_ANY_DIGITAL_WALLET",
"currency": "USDT",
"extra": {
"quoteAmount": 10,
"quoteCurrency": "CNY",
"quotePrice": 10
},
"key": "h3cS7dBltRU4W1wD",
"localOrderId": "2820",
"merchantActualAmount": 22.72,
"merchantCurrency": "CNY",
"merchantId": 303122065665,
"merchantPaidAmount": 7.33,
"notifyTime": 1736744168370,
"orderCreateTime": 1731572133082,
"orderId": "273124814912907",
"sign": "699806308a9e055114c378671b0d2a15",
"status": "SUCCESS",
"type": "WITHDRAW",
"userAmount": 1,
"userCurrency": "USDT"
}
参数名称 | 类型 | 参与签名 | 参数含义 | 参数说明 |
---|---|---|---|---|
amount | decimal | 是 | 订单金额 | |
bizType | enum | 是 | 订单类型 | bizType 类型说明如下 |
currency | String | 是 | 币种 | |
key | String | 是 | 商户 key | |
localOrderId | String | 是 | 本地订单号 | |
merchantActualAmount | decimal | 是 | 商户实际收款金额 | |
merchantCurrency | String | 是 | 商户收款币种 | 默认币种 |
merchantId | String | 是 | 商户号 | |
merchantPaidAmount | decimal | 是 | 商户收款金额 | |
merchantUserId | String | 是 | 用户 id | |
notifyTime | long | 是 | 回调时间 | |
orderCreateTime | long | 是 | 订单创建时间 | |
orderId | String | 是 | 订单号 | |
status | String | 是 | 支付状态 | |
type | String | 是 | 订单类型 | PAYMENT:支付 WITHDRAW:提款 |
userAmount | decimal | 是 | 用户付款金额 | |
userCurrency | String | 是 | 用户支付币种 | |
sign | String | 否 | md5 签名 | 详情看签名算法 |
extra | object | 是 | 包含一下参数 | |
└quoteAmount | number | 是 | 订单报价金额 | |
└quoteCurrency | number | 是 | 订单报价币种 | |
└quotePrice | string | 是 | 订单报价价格 |
bizType 类型说明:
1、PAYMENT_WALLET_SCAN Vpay钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至Vpay钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付
如果您接受到了回调信息,只需要返回success
,即表示消息已处理,本条回调不再会发送,否则会尝试重 复发送直到获得期望的响应, 目前的重试频率为15s, 15s, 30s, 180s, 600s, 1200s, 1800s
,都无响应后,不再重复发送。